home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_2 / sprtrv11.zip / SYSOP.DOC < prev   
Text File  |  1992-03-20  |  15KB  |  382 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.                            NCAA SPORTS TRIVIA
  11.                               SYSOP'S MANUAL
  12.  
  13.                                  v1.0
  14.  
  15.                              March 20, 1992
  16.                          PCBoard 14.x and GAP 4.x
  17.                            WILDCAT!, SPITFIRE
  18.                              QBBS, RBBS, RA
  19.                                   WWIV
  20.  
  21.                                    by
  22.  
  23.                              Dennis Maidon
  24.  
  25.                           The Parole Board BBS
  26.  
  27.                         (919) 965-4696 - Node 1
  28.  
  29.                         (919) 965-0068 - Node 2
  30.  
  31.                         (919) 965-9885 - Node 3
  32.  
  33.             All nodes are running US Robotics Dual Standards
  34.  
  35.                                 OVERVIEW
  36.                                 ________
  37.  
  38.  
  39. CONGRATULATIONS!  You and your users will find NCAA Sports Trivia
  40. entertaining and educational.  NCAA Sports Trivia is a carefully
  41. selected collection of 1750 questions segregated into user
  42. selectable multiple categories.  Your users can limit, mix or
  43. combine the question categories.  The program maintains a record of
  44. replies so the user may resume answering questions on another call. 
  45. The door displays a "top trivia player bulletin to the caller while
  46. it creates bulletins and logs for your use.  Best of all..this door
  47. is not crippleware.  It isn't full of advertisements and
  48. limitations...best of all I don't charge an arm and a leg.  You'll
  49. also find we are responsive to your questions.  If you need help or
  50. have a suggestion for improving this product, let me know!
  51.                      FILES AND DESCRIPTIONS
  52.                      ______________________
  53.  
  54. The archive includes the following files:
  55.  
  56.      SPRTRV.EXE     -- The main executable file
  57.      SAMPLE.CFG     -- The sample configuration file
  58.      SPRTRV.DAT   -- The main trivia data file
  59.      SAMPLE.LOG     -- A sample of the log file produced
  60.      SCREENS.ZIP    -- Screens for the SPRTRV\SCREENS sub directory
  61.          ^┌──WELCOME.ANS  -- The program color Welcome Screen,
  62.          ││                  (Can be modified by Sysop).
  63.          ││  WELCOME.ASC  -- The program mono Welcome Screen
  64.          └┤                  (Can be modified by Sysop).
  65.           │  INSTRUCT.ANS -- The color user instruction file
  66.           └──INSTRUCT.ASC -- The mono user instruction file
  67.      SYSOP.DOC    -- The installation instructions...(this file)
  68.      QUIKUP.DOC   -- Quick and Dirty installation instructions.
  69.      MAINTAIN.ZIP -- Program to trim the scores database.
  70.      LOCAL.ZIP    -- Sample door.sys and userinfo.dat for
  71.                      local testing.
  72.      REGISTER.TXT -- Information and registration form...This will
  73.                      give you a personalized door, voice or bbs   
  74.                      support services, new issues of master.dat   
  75.                      files, a clear conscience and a still poor but
  76.                      happy door programmer.
  77.      SAMPLE.BAT      Sample door batch file
  78.      
  79. This ZIP file was created using the -AV function of PKZIP.  If my
  80. AV is missing then this file may not be complete of has been 
  81. tampered with.  Complete and current editions of this program are
  82. always available for D/L on The Parole Board BBS.  If the AV is
  83. missing please complain to your sysop to stop the practice of
  84. removing AV's as this is your assurance from the programmer that
  85. the file is complete and virus free.
  86.  
  87.  
  88.                               INSTALLATION
  89.                               ____________
  90.  
  91.    Installation is quite simple and straight-forward. Follow these
  92. steps and example and you should be up and running in a matter of
  93. minutes.  Although SPRTRV is an easy program to install on most any
  94. BBS, there may be some Sysop who has trouble.  Support is available
  95. in those situations.
  96.  
  97.  
  98.       1) Create a directory to hold all SPRTRV files
  99.  
  100.       2) Unzip SPRTRVxx.ZIP into the above directory
  101.  
  102.       3) Run INSTALL.BAT
  103.  
  104.       4) Create a configuration file, with a name of your choice
  105.          or modify the SAMPLE.CFG file which is enclosed.
  106.  
  107.       5) Create a door batch file or use the sample enclosed.
  108.  
  109.  
  110.       6) Modify your particular BBS System Menus to add the
  111.          door.  The BBS setup various depending on the type BBS   
  112.          software you are running.  We assumed you are familiar   
  113.          with the general DOOR setup on your system.  Therefore our
  114.          description includes only examples of the SPRTRV specific
  115.          configuration file and door batch file.  Refer to your
  116.          BBS documentation for door installation on your
  117.          particular software.
  118.  
  119.       7) If not already on your system, be sure to add BRUN45.exe
  120.          into a directory on your path.  BRUN45.EXE is NOT included 
  121.          but IS required !!!  You can download  BRUNxx.EXE modules 
  122.          from many BBS systems or they are available on the PAROLE 
  123.          BOARD.  You only need one copy, even if you run other    
  124.          doors which use BRUN45.EXE.
  125.  
  126.  
  127.  
  128. BBS USER FILES
  129.  
  130.      The BBS user file provides information to SPRTRV !!, such as COM
  131.      port, user name, time allowed in the door, etc.  This file is
  132.      necessary for SPRTRV to function.  The complete path\filename of
  133.      the BBS user file must be passed to SPRTRV.EXE as the 1st
  134.      parameter in the command line.  The user file is created by
  135.      your BBS EACH time a user runs a door....The BBS USER file has
  136.      a different name on each type of BBS.  When you create your
  137.      SPRTRV configuration file, you must tell SPRTRV the name for your
  138.      particular BBS system.
  139.   
  140.      The following is a list of the user files used by the        
  141.      BBS types we support (we included a typical path).
  142.  
  143. drive\dir\filename
  144.    C:\WILDCAT\CALLINFO.BBS ──┐  <- For Wildcat!
  145.    C:\WC30\USERINFO.DAT      │  <- For Wildcat! 3.0
  146.    C:\PCB\PCBOARD.SYS        │  <- For PCBoard using PCBOARD.SYS  
  147.                                    only
  148.    C:\PCB\USERS              │  <- For PCBoard using USERS only
  149.    C:\BBS\DOOR.SYS           │  <- For Systems which support      
  150.                                    DOOR.SYS
  151.    C:\BBS\DORINFOx.DEF       │  <- For QBBS/RBB/RA.  Replace x with 
  152.                                    Node #.
  153.    C:\BBS\SFDOORS.DAT        │  <- For Spitfire
  154.    C:\BBS\CHAIN.TXT       ───┘  <- For WWIV
  155.  
  156.  
  157. CONFIGURATION FILE
  158.  
  159. One (and only ONE) of the above will be LINE 1 of your
  160. configuration file. You MUST specify the path and name (including
  161. any extension) correctly if you expect SPRTRV to find it.  Sample for
  162. Lines 2 through 10 are:
  163.  
  164.    The Parole Board BBS         <- Your BBS Name
  165.    Dennis                       <- SysOp's First Name
  166.    Maidon                       <- SysOp's Last Name
  167.    00000                        <- Registration Number
  168.    100                          <- Minimum security level allowed 
  169.                                    in door.
  170.    35                           <- Maximum questions allowed per visit
  171.                                    to the door.
  172.    C:\WC\BULL\BULL1.SCR         <- Path and Name of Color Bulletin
  173.    C:\WC\BULL\BULL1.BBS         <- Path and Name of ASCii Bulletin
  174.    Y                            <- (Y/N) Create WC!3.x specific
  175.                                    bulletins or not.  Y = WC! Bulls
  176.  
  177.      Edit the Sample.CFG file to suit your individual BBS.  You
  178. must have all 10 lines and no extra characters.
  179.  
  180.   Line 1:  This line points to where SPRTRV.EXE will find the callers
  181.            information file.  Just include the line that your     
  182.            particular BBS uses.  DO NOT put all of them in the CFG 
  183.            file.
  184.  
  185.    Line 2:  Place the name of your BBS on this line.
  186.  
  187.    Line 3:  SysOp's first name goes here.
  188.  
  189.    Line 4:  SysOp's last name goes here.
  190.  
  191.    Line 5:  Your Registration Number goes here if registered.  If
  192.             you haven't registered you can still use the          
  193.             door...just enter 00000 until you get your registration 
  194.             number.
  195.  
  196.    Line 6:  The minimum security level that is allowed in the door.
  197.  
  198.    Line 7:  Maximum number of questions allowed per visit to the door.
  199.             I would suggest 25-30 as a reasonable number.  The smaller
  200.             this number, the more likely that the users will continue to
  201.             use the door.
  202.  
  203.    Line 8:  Enter the complete path and name of the ANSI bulletin
  204.             that you want SPRTRV to create.
  205.  
  206.    Line 9:  Enter the complete path and name of the ASCii bulletin
  207.             that  you want SPRTRV to create.
  208.  
  209.    Line 10:  YES to create WC!3.x specific bulletins or NO for ANSI and
  210.              ASCii bulletins.  If you Config for WC! bulletins, Place
  211.              the name of the bulletin on Line 8 of the CFG file.  Be
  212.              sure to add the ".BBS" extension to it.  You may leave Line
  213.              9 blank but it still MUST be included in the CFG file.
  214.  
  215.  
  216.          If you use the sample CFG file be sure to remove all
  217. remarks and use  a pure ASCII editor such as EDLIN or QEDIT.  Word
  218. processors typically leave hidden control codes. Those hidden codes
  219. could cause the program to depart for worlds unknown.  Save your
  220. newly edited file using any name you want....suggested SPRTRV1.cfg.
  221.  
  222.  
  223.  
  224.  
  225.  
  226. DOOR BATCH FILE
  227.  
  228.          Create a batch file or modify the sample SPRTRV.BAT file
  229.          supplied. This is what you need:
  230.  
  231.   @ECHO OFF               Keeps a clean screen (optional)
  232.   CD \DOORS\SPRTRV           Change to the SPRTRV door files directory
  233.   SPRTRV SPRTRV1.CFG      Run SPRTRV using SPRTRV1.CFG configuration
  234.   CD\WCAT                 Change back to the WCAT BBS directory
  235.   CAT.BAT                 Restart the BBS.  On BBSs which shell to 
  236.                           dos to run the door this line may be    
  237.                           omitted or maybe the word "EXIT."  Check 
  238.                           your BBS door instructions.
  239.  
  240. MULTIPLE NODES
  241.  
  242.         Create a configuration file for each node.  Each file     
  243.         should have a unique name.  
  244.  
  245.         EX: SPRTRV1.CFG  SPRTRV2.CFG
  246.  
  247.         SPRTRV has been tested under LIVECAT and DESQVIEW and performs
  248.         very well under either or both.
  249.  
  250.  
  251. LIVECAT! USERS  (WILDCAT!3.0 ONLY!!!!!!)
  252.  
  253.     If you are using LIVECAT! to control your doors you will need
  254. to make one small change in your door.bat file.  LC! changes
  255. DOOR.SYS to DOOR.ORG when it shells out to the door.  You will need
  256. to add this line in your script right after echo off 
  257.  
  258.                 COPY DOOR.ORG DOOR.SYS
  259.  
  260.     If you don't do this, SPRTRV just gives up and dies a very unhappy
  261. death.  Don't worry about deleting the copied file when SPRTRV
  262. finishes ....there are no reported problems with it.  
  263.  
  264.  
  265. COMM PORT IRQs
  266.  
  267. SPRTRV is written using DoorFrame.   DoorFrame supports COM 1-4 on the
  268. standard IRQ's - COM1 or COM3 as a standard uses IRQ4 while  COM2
  269. and COM4 use IRQ3.  If your system uses a non-standard IRQ, add the
  270. IRQ  number after the configuration filename. Let's assume your
  271. Door is called FOOBAR and you want to use COM1 but non-standard
  272. IRQ5. The command line  passed to your Door would be:
  273.  
  274.         FOOBAR FOOBAR.CFG /5
  275.  
  276.       The /5 tells DoorFrame to use IRQ5 rather than the standard
  277. IRQ4 normally used with COM1. No /x parameter is needed for the
  278. standard IRQ's.
  279.  
  280.  
  281. TIPS AND TRAPS
  282.  
  283.       Be sure to read all the READ.ME, README.1ST AND UPGRADE.DOC
  284. files if they are included in the package.  They sometimes contain
  285. some very useful information. <G>  
  286. Of course you can do like me, just set the darn thing up without
  287. the docs then fuss at the door author for not making it simple
  288. enough to work the first time.
  289.  
  290.       IF You get an error...check every path to make sure you typed
  291. it correctly.  Check the file name...does it match exactly?  Does
  292. the configuration filename match?  Did you leave off the
  293. configuration file extension?   Do you have the correct BRUN module
  294. in a directory on your path?  If all those seem correct and the
  295. door still won't work...call me......preferably not in the middle
  296. of the night...no door is that important.
  297.  
  298.       When the door is in use...you can use the sysop options
  299. listed at the bottom of your screen to chat, increase or decrease
  300. the users time or log the user off.
  301.  
  302.  
  303.  
  304.  
  305.                                 MISCELLANEOUS NOTES
  306.                                 ===================
  307.  
  308. DoorFrame requires DOS 3.x and up since all files are opened in SHARED mode.
  309.  
  310. When using PCBOARD.SYS, SPRTRV requires that PCBOARD.DAT be in the same
  311. directory as PCBOARD.SYS. SPRTRV also accesses the USERS file.
  312.  
  313. When using USERS.SYS, SPRTRV also accesses PCBOARD.SYS, PCBOARD.DAT and the
  314. USERS file.
  315.  
  316. The DOOR.SYS used by SPRTRV is the standard 52 line GAP (tm) file.
  317.  
  318. The CALLINFO.BBS used by SPRTRV currently contains 36 lines.
  319.  
  320.  
  321.  
  322.                               LEGALITIES
  323.                               __________
  324.  
  325.  
  326.       THIS SOFTWARE AND ACCOMPANYING MATERIALS ARE DISTRIBUTED "AS
  327. IS"  WITHOUT WARRANTY, EXPRESS, IMPLIED OR STATUTORY, INCLUDING BUT
  328. NOT LIMITED TO ANY IMPLIED WARRANTIES OF MERCHANTABILITY AND
  329. FITNESS  FOR A PARTICULAR PURPOSE. IN NO EVENT SHALL ANYONE
  330. INVOLVED WITH THE CREATION AND PRODUCTION OF THIS PRODUCT BE LIABLE
  331. FOR INDIRECT, SPECIAL, OR CONSEQUENTIAL DAMAGES, ARISING OUT OF ANY
  332. USE THEREOF OR BREACH OF ANY WARRANTY.
  333.  
  334.  
  335.                              DISTRIBUTION
  336.                              ____________
  337.  
  338.    You may make this file available for downloading from your BBS
  339. or you may  upload it to any BBS of your choice, provided that you
  340. do not make any  changes to the contents of the archive (ZIP file).
  341. The archive and its  individual contents may not be used by any
  342. service that charges any money whatsoever, without the written
  343. permission of the author.
  344.  
  345.                              REGISTRATION
  346.                              ____________
  347.  
  348.    I am not a subscriber to the "Crippleware" concept, and this
  349. program  reflects that philosophy. This is a full-featured program,
  350. whose functionality is not hampered in any way, whether you
  351. register it or  not.  It is only $15 to register this door.
  352.  
  353.    Remember, whether you are registered or not, should you have any
  354. problems, questions or suggestions for improvements, be sure to
  355. drop me a message on either of the aforementioned BBS or via the
  356. DOORS or SYSOP conference on RIME(tm), Node ID = PAROLE.
  357.  
  358.  
  359.                                  THANKS
  360.                              --------------
  361.  
  362.     Special thanks goes out for my wife who is definitely a
  363.     "Computer Widow".
  364.  
  365.     Ted Freeman the author of DoorFrame, a first class BBS Doors
  366.     Development Library.
  367.  
  368.     My BBS users who have had to endure constant badgering to help 
  369.     me test the programs that I have written.
  370.  
  371.     A *VERY SPECIAL THANKS* to Mustang! Software for developing the 
  372.     greatest BBS Software on the market, WILDCAT! 3.x.  And about 
  373.     to be even better when they revamp the on-line chat feature.
  374.  
  375.     Liane Benway, SysOp, Running Wild !!! in Norcross, GA.  Without
  376.     Liane, you wouldn't have these fine DOCs.
  377.  
  378.     John Kutas, SysOp, THE SWINGERS CONNECTION BBS in Philadelphia, PA.
  379.     After countless long hours on the telephone, we finally solved the
  380.     world's problems.
  381.  
  382.